docs: point org-contract-map at wasmagent-protocol as canonical SSOT - #131
Merged
Conversation
The contract map (self-described 'authoritative reference') was last updated 2026-07-21, before wasmagent-protocol was created (2026-07-23) as the canonical source of truth for all cross-repo schemas. It still listed wasmagent-js, agent-trust-infra, symkernel, and bscode as canonical schema owners and had no mention of wasmagent-protocol — so it was actively directing downstream repos to keep local schema copies, causing drift. Rewrite so that: - All cross-repo schemas are owned by wasmagent-protocol (single source), with the versions from its schemas/index.json. - The old 'owner' becomes 'Domain steward' (design ownership), which proposes changes through the protocol contract-change process; the JSON lives only in wasmagent-protocol. - Explicit repo-local schema table (single-consumer, intentionally not centralized). - Coupling rules updated: never copy/fork schema JSON; vendor verbatim + CI drift gate if a package is unavailable (symkernel make sync-schemas as reference); no local-only field extensions.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Root cause
docs/org-contract-map.mdcalls itself "the authoritative reference — individual repo CLAUDE.md files should agree with this table", but it was last updated 2026-07-21, two days beforewasmagent-protocolwas created (2026-07-23) as the canonical source of truth for all cross-repo schemas.The stale map still listed
wasmagent-js,agent-trust-infra,symkernel, andbscodeas canonical schema owners and never mentionedwasmagent-protocolat all. It was therefore actively directing downstream repos to keep local schema copies — the exact driftwasmagent-protocolexists to prevent.An org-wide audit (2026-07-27) found real drift traceable to this:
trace-pipeline(7 forked schemas + local-only fields),agent-trust-infra(agentbom/mcp-posture copies),open-agent-audit(trust-passport copy + a competingschemas/index.json), andwasmagent-js(generatedaep-recordcopy). Follow-up issues track each repo's cleanup.Change
wasmagent-protocolas the canonical source, with versions taken from itsschemas/index.json.wasmagent-protocol.symkernel'smake sync-schemasis the reference); no local-only field extensions.